PBDTFlushSync
PBDTFlush Save changes to the desktop database.
OSErr PBDTFlush(paramBlock, async); DTPBPtr paramBlock ; pointer to a DTPB Param Block
Boolean async; 0 = await completion; 1 = immediate return Parameter block
ۮ 12 ioCompletion long completion routine
۬ 16 ioResult short result code
ۮ 24 ioDTRefNum short database reference number
PBDTFlush writes the contents of the desktop database specified in
ioDTRefNum to the volume.
Note: If your application has manipulated information in the database
must call PBDTFlush to update the copy stored on the volume.
Returns: an Error code. It will be one of the following:
noErr (0) No error
ioErr (-36) I/O error
wPrErr (-44) Volume is locked through hardware
vLckdErr (-46) Volume is locked through software
rfNumErr (-51) Reference number invalid
extFSErr (-58) External file system-file system identifier is nonzero
Note: There is a second, asynchronous, version of this function. It does not take a
second parameter; instead, it adds the suffix "Async" to the name of the
routine.
Similarly, the third (synchronous) version of the routine does not take a
second parameter; instead, it adds the suffix "Sync" to the name of the
routine.
Note, however, that the second and third versions of these routines do not
use the glue code that the first versions use and are therefore more
efficient.